home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Online / hsc / docs-source / author.hsc < prev    next >
Encoding:
Text File  |  1997-10-10  |  5.5 KB  |  135 lines

  1. <WEBPAGE chapter="hsc - " title="How To Reach The Author"
  2.     PREV="copy.html"
  3.     NEXT="updates.html"
  4.     QTEXT=("And I walk<BR>"
  5.          +"Through confusion<BR>"
  6.          +"With a smile on my face")
  7.     QAUTHOR='Ride, "Natural Grace"'>
  8.  
  9. <P>The main reason because this topic is one of the first if you are
  10. browsing this documentation sequentially is <EM>not</EM> that I want
  11. to receive as much email as possible. This page is designed to keep
  12. my email traffic as low as possible.</P>
  13.  
  14. <H2>Before You Contact Me</H2>
  15.  
  16. <P>I know I can't expect you to read the whole manual, but make sure
  17. you have read the sections about 
  18. <A HREF="questions.html">Questions And Answers</A>,
  19. <A HREF="related.html">Related Stuff</A> (and tools),
  20. <A HREF="future.html">Future improvements</A>
  21. and <A HREF="bugs.html">Known Bugs, Problems And Limitations</A> before
  22. you contact me.</P>
  23.  
  24. <P>There are also chapters about <A HREF="source.html">compiling</A>
  25. and <A HREF="install.html">installing</A>, and you should at least
  26. give a glimpse at them. For non-Amiga users, there is a chapter about
  27. all those <A hREF="ports.html">existing ports to other systems</A>
  28. describing differences.</P>
  29.  
  30.  
  31. <P>Maybe there is already a bugfix available at the <hsc-support>,
  32. so check this, too. (Note: Traditionally, the most distressing bugs
  33. are reported and fixed a few days after a new release showed up in
  34. Aminet, so it's probably a good habit to take a look at this page
  35. about a week after downloading <hsc> from Aminet.)</P>
  36.  
  37. <H2>On What To Contact Me</H2>
  38. If you..
  39. <UL>
  40. <LI>..find any new bugs (which seems to become more and more unlikely)
  41. <LI>..think that <hsc> accepts severe errors in your sources without
  42.     warning about it; note the word <EM>severe</EM> in the last sentence.
  43. <LI>..have any questions about <hsc> and it's usage which are not covered
  44.     sufficiently in this documentation or located at a completely
  45.     unexpected place (which should be quite unlikely because I meanwhile
  46.     consider this documentation to be quite useful). Please note that
  47.     I do not want to be bothered by problems concerning tools not included in
  48.     this package, like <make>.
  49. <LI>..want to port <hsc> to another system that supports some sort of
  50.     command line interface. 
  51.     See also <A HREF=":ports.html">Existing ports</A>.
  52. <LI>..have any (reasonable) suggestions how to improve <hsc>; but note that I'm 
  53.     currently not thinking about any conceptional changes.
  54. </UL>
  55. you should contact me.
  56.  
  57. <H2>On What NOT To Contact Me</H2>
  58.  
  59. You should not contact me on the following topics:
  60.  
  61. <UL>
  62. <LI>You just want to say <qq>hi!</qq> and tell me that <hsc> is a
  63.     great tool. 
  64.     <TG>ARROGANCE</TG>I already know that.<TG>/ARROGANCE</TG>.
  65. <LI>You want to compile <hsc> for your system but don't have 
  66.     enough experience on such things. Bad luck for you, try to
  67.     increase your circle of acquaintances.
  68. <LI>You think <hsc> is a great program, and you want to use it
  69.     with some MS-DOS-based system like Windows NT, Windows 95
  70.     or OS/2.
  71. <LI>Your compiler has problems compiling a simple ANSI-C program.
  72.     (You won't believe it, but there are still such compilers around)
  73. <LI>General discussion about html tags and how to use them. I don't
  74.     know the correct usage of several tags defined in <hsc.prefs>
  75.     myself.
  76. </UL>
  77.  
  78. If you fail to exclude the above topics from your email, you might
  79. get a reply consisting of a single term: 
  80. <qq>Read the fucking manual!</qq>.
  81.  
  82. <H2>About Bug Reports</H2>
  83.  
  84. If you think you've found a bug that is not already mentioned or
  85. discussed in the chapter about <ln_bugs>, you should include some
  86. information in your bug-report:
  87.  
  88. <UL>
  89. <LI>Under which operating system did you use <hsc>?
  90. <LI>Which version of <hsc> did you use? You can find this out if you
  91.     invoke <hsc> without any arguments or simply type 
  92.     <qq><CODE>hsc HELP</CODE></qq> in your shell. Always include version number
  93.     and exact date, do not use terms like <qq>the latest version</qq>.
  94.     The CLI option <CODE>HELP</CODE> also exists for all other tools coming
  95.     with this package.
  96. <LI>Include a single command call or batch-script and hsc source
  97.     (or at least part of) that reproduces the bug.
  98. <LI>Do not send me all your sources for your whole site, try to trace
  99.     the bug back to a single input-file and macro, if possible.
  100. </UL>
  101.  
  102. <P>You don't have to provide information about the exact version of
  103. the operating system or compiler used, as <hsc> is supposed to be
  104. rather system independent, but I might asked you for that in a reply,
  105. so keep this at hand.<P>
  106.  
  107. <P>The more specific and smaller your bug-report is, the more likely
  108. I might fix it; although  I can't promise that I will fix all bugs
  109. reported to me in reasonable time.</P>
  110.  
  111. <P>If your bug-report fails to include the above informations, I might
  112. completely ignore it.</P>
  113.  
  114. <H2>...And Finally</H2>
  115.  
  116. <P>You can reach me via email using <EMAIL ADDRESS="agi@giga.or.at"> or
  117. <EMAIL ADDRESS="agi@sbox.tu-graz.ac.at">. Note that I might
  118. reply from another address, but add only one of these two to your
  119. address book, they should be valid for a longer time.</P>
  120.  
  121. <P>If you include binary data, MIME-attachments are accepted.
  122. Preferred archives are <CODE>.lha</CODE>, <CODE>.lzx</CODE> and
  123. <CODE>.tar.gz</CODE>. If it is necessary, I can cope with
  124. <EXEC>uuencode</EXEC>, but please try avoid it if possible, as I'm
  125. awfully lazy - I always have to look at the manpage for it.</P>
  126.  
  127. <P>You can use English or German for communication, with the first
  128. one being preferred.</P>
  129.  
  130. <P>There is no mail address as this changes too frequently.</P>
  131.  
  132. <P>As an act of protest, there also is no homepage.</P>
  133.  
  134. </WEBPAGE>
  135.